home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / domain < prev    next >
Encoding:
Text File  |  1996-04-21  |  8.3 KB  |  213 lines
  1.  
  2. domain <subcommand>
  3.  
  4.      The domain commands control and show the working of the name  to
  5. Internet address  mapping software (referred to as DNS: Domain Name Service).
  6. JNOS has both a DNS client and a server.  The server will answer queries from
  7. data in the domain cache, and from information stored in the DOMAIN.TXT file.
  8. The DNS server is only available when DOMAINSERVER is defined in config.h,
  9. but the DNS client is always available.
  10.      
  11.  
  12.     domain addserver <hostid> [<timeout>]
  13.  
  14.      Add a domain name server to the list of name servers.
  15.  
  16.      <timeout> is an optional timeout setting in seconds for
  17.      this server.  If <timeout> is not included in the command, the
  18.      value defaults to 3 * (tcp_irtt).  Servers are queried in the
  19.      opposite order in which they were added.
  20.      
  21.           Example:  domain addserver wg7j.ece.orst.edu
  22.                     domain addserver 128.193.48.1
  23.                     domain addserver ucsd.edu
  24.           
  25.           
  26.     domain cache <subcommand>
  27.  
  28.      The following commands work on the domain cache, which contains
  29.      resource records held in memory (see RFC1033/1034).
  30.      
  31.        domain cache clean [<yes | NO>]
  32.  
  33.         Displays or sets the discarding of expired resource records.
  34.         Expired records have their time-out value decremented to zero.
  35.         Normally resource records get a default time-out value of 1800
  36.         seconds.  After this time they are  considered "old" and if
  37.         referenced again the domain name resolver should be inquired
  38.         again.  When clean is NO (the default), expired records will
  39.         be retained; if no replacement can be obtained from another
  40.         domain name server, these records will continue to be used.
  41.         When clean is YES, expired records will be removed from the
  42.         file whenever  any new record is added to the file.
  43.           
  44.           
  45.        domain cache dump
  46.  
  47.         Immediately clears the domain cache.
  48.         
  49.         
  50.        domain cache list
  51.  
  52.         This command shows the current content of the in-memory  cache
  53.         of  resource records.
  54.      
  55.  
  56.        domain cache size [<size>]                       Default: 5
  57.  
  58.         (B)    Display or set the maximum size (number of entries) of
  59.         the local in-memory domain cache.
  60.         Example:  domain cache size 10
  61.  
  62.                     
  63.        domain cache wait [<secs>]                        Default: 300
  64.  
  65.         Display or set the number of seconds which must elapse before
  66.         the domain.txt file is updated from the resource records stored
  67.         in the domain cache.  Updating is controlled by the 'domain
  68.         update' command (see also).
  69.  
  70.  
  71.     domain dns [on|off]
  72.  
  73.      (B)  Display or  toggle the state of the Domain Name Server.  If
  74.      on, the system is active as a Domain Name Server. The system will
  75.      then answer queries from other tcp/ip hosts regarding hostname to
  76.      ip-address, and ip-address to hostname translations.  For more
  77.      information, see the section SETTING UP THE DOMAIN NAME SYSTEM (in
  78.      the JNOS40 CONFIGURATION MANUAL, the relevant section is called
  79.      'Configuring the Domain Name System').
  80.  
  81.      The dns subcommand is only available when DOMAINSERVER was defined
  82.      when Jnos was compiled.
  83.      
  84.  
  85.     domain dropserver <hostid>
  86.  
  87.      Remove a domain name server from the list of name servers.   You
  88.      are  warned when you delete the last name server.
  89.      Example:  domain dropserver ece.orst.edu
  90.           
  91.           
  92.     domain listservers
  93.  
  94.      List the currently configured domain name servers, along with
  95.      statistics  on how  many  queries  and  replies  have been
  96.      exchanged with each one, response times, etc.
  97.      
  98.  
  99.     domain look <search_text>
  100.  
  101.      This command searches domain.txt and displays records matching
  102.      <search_text>.  The supplied <search_text> must match exactly, ie,
  103.      case is significant.  This subcommand is available only if
  104.      MORESESSION was defined when Jnos was compiled.
  105.  
  106.  
  107.     domain maxclients [<N>]                                Default: 6
  108.  
  109.      This command sets or displays the maximum number of simultaneous
  110.      DNS server processes allowed.  This subcommand is available only if
  111.      DOMAINSERVER was defined when Jnos was compiled.
  112.  
  113.  
  114.     domain maxwait [<time-out>]
  115.  
  116.      (B)  This sets a time-out value (1 to 255 seconds) for a query of
  117.      a domain name server.   This is not set for an already defined
  118.      server but will be used for a newly defined name server.  Also
  119.      the value is used for domain name lookups (E.g. when a user does
  120.      a telnet to a host with the nodeshell 'T host' command).  Note
  121.      that (PC based) name servers can have trouble finding records in
  122.      a large database.  Default is 60 seconds.
  123.      Example:  domain maxwait 10
  124.           
  125.           
  126.     domain query <hostid>
  127.  
  128.      The query command displays the results of asking the DNS servers for
  129.      any domain records for <hostid>.  THis command is available when Jnos
  130.      was compiled with DQUERYSESSION #define'd.
  131.  
  132.  
  133.     domain retries [<retries>]
  134.  
  135.      (B)  The retry value (number) limits the number of queries  sent
  136.      out to remote domain  name resolvers before giving up and telling
  137.      you that host xyzzy.ampr.org does not exist.  The total time lost
  138.      with a query is (retries * time-out * number of domain servers
  139.      defined); i.e., the delay between requesting a hostname to ip-
  140.      address translation and getting the answer can become very long
  141.      if you use many servers, and set the time-outs/retries high !
  142.      Default is 2.
  143.      Example:  domain retries 1
  144.  
  145.  
  146.     domain subnet [ON | off]
  147.  
  148.      This command works in conjunction with 'domain translate' to
  149.      allow or disallow translation of any address ending in 0 or 255.
  150.      On systems which have a lot of subnets, turning off subnet
  151.      translation can result in a considerable speedup when displaying
  152.      routes with 'domain translate on'.
  153.  
  154.  
  155.     domain suffix [<domain suffix> | none]
  156.  
  157.      Display or specify the default domain name suffix to be appended
  158.      to a host name when it contains no periods.  For example, if the
  159.      suffix is set to "ampr.org." and the user enters 'telnet ka9q',
  160.      the domain resolver will attempt to  find 'ka9q.ampr.org.' If the
  161.      host name being sought contains one or more periods, however, the
  162.      default suffix is NOT applied if the last part of the name is
  163.      less than 5 characters and contains only letters; e.g., 'telnet
  164.      foo.bar' would NOT be turned into 'foo.bar.ampr.org.' 'telnet
  165.      foo.ka9q' will be turned into 'foo.ka9q.ampr.org.' Note  that a
  166.      trailing dot (.) is required for the suffix.  If the suffix is
  167.      the string 'none' (without trailing period), the current suffix
  168.      is cleared and forgotten.  Default is "ampr.org."
  169.      Example:  domain suffix ece.orst.edu.
  170.  
  171.  
  172.     domain trace [on| OFF]
  173.  
  174.      (B)  Display or set the flag controlling the tracing of domain
  175.      server requests and responses.  This only works when console is
  176.      enabled.  Default is off.
  177.      Example:  domain trace on
  178.           
  179.           
  180.     domain translate [on | OFF]
  181.  
  182.      (B)  Display or set the flag that controls the translation of  ip
  183.      addresses in dot notation into symbolic names.  The translation
  184.      process makes heavy use of reverse domain name lookups.  Do not
  185.      set this flag unless you have a good and fast connection to a
  186.      domain name server.
  187.      Example:  domain translate on
  188.           
  189.           
  190.     domain ttl [ttl]
  191.  
  192.      Select a default 'ttl' value to be applied to server responses
  193.      than contain none.  This subcommand is available only if
  194.      DOMAINSERVER was defined when Jnos was compiled.
  195.           
  196.           
  197.     domain update [ON | off]
  198.  
  199.           
  200.      Controls whether or not the domain.txt file is updated with server
  201.      responses.  See also 'domain cache wait'.
  202.  
  203.  
  204.     domain verbose [on | OFF]
  205.  
  206.      (B)  Display or set the flag controlling the return of a full name
  207.      (on) or only the first name (dot delimiter) (off).  This is for
  208.      IP address to name translation only.  If off, home.wg7j.ampr.org.
  209.      will show as 'home.wg7j', whereas if on it will show as
  210.      'home.wg7j.ampr.org'
  211.      Example:  domain verbose on
  212.           
  213.